Summary Table and Diagram of QuickDraw GX Objects (IM: XO)

Inside Macintosh: QuickDraw GX Objects /: Chapter 1 - Introduction to QuickDraw GX

Summary Table and Diagram of QuickDraw GX Objects
QuickDraw GX provides at least 17 objects that you can manipulate. Table 1-2 lists these objects and summarizes their characteristics. Following Table 1-2, Figure 1-13 on page 1-49 diagrams the relationships among the basic QuickDraw GX objects, and shows the object properties of each.
QuickDraw GX objects (Continued)
Object Description
Basic QuickDraw GX objects
Shape Defines the basic representation of a drawable entity. A shape object describes a geometry of a certain type (such as a line, rectangle, bitmap, or text) and how the geometry is framed or filled when drawn. A shape also has references to its three related objects: style, ink, and transform. See the chapter "Shape Objects" of this book for more information. Graphic shape types are described in Inside Macintosh: QuickDraw GX Graphics; typographic shape types are described in Inside Macintosh: QuickDraw GX Typography.
Style Describes certain characteristics affecting how a shape is drawn. For geometric shapes, this includes the thickness of the pen, the starting and ending caps for line segments, joins between line segments, and the dash or pattern to be applied to the shape.
For typographic shapes, it includes the font, text size, and typeface of the text. See the chapter "Style Objects" in this book, the geometric styles chapter of Inside Macintosh: QuickDraw GX Graphics, and the typographic styles and layout styles chapters
of Inside Macintosh: QuickDraw GX Typography for more information.

Ink Describes a shape's color and its transfer mode (how the color
is applied when the shape is drawn). Ink objects support many different kinds of color specification, and many different
transfer modes. An ink object can reference a color set object or color profile object or both. See the chapters "Ink Objects" and "Color-Related Objects" in this book for more information.
Transform Describes the clip and mapping applied to a shape when it is drawn. The clip limits the extent of the shape when it is drawn; it may be described by any primitive shape geometry (except picture, text, layout, and multi-bit bitmap). The mapping
defines translation, scaling, skewing, rotation or perspective.
The transform object also describes the criteria used for hit-testing the shape. Transforms have references to one or more view port objects. See the chapter "Transform Objects" in this book for more information.
Color set Contains an indexed set of colors; analogous to a color table. Color sets are used when colors are specified by index instead
of by direct color value. Bitmaps commonly use color sets. See the chapter "Colors and Color-Related Objects" in this book for more information.
Color profile Contains color matching information. The information in a
color profile can be used to convert device-specific colors to device-independent colors and back. To provide the most faithful reproduction of colors on different devices, QuickDraw GX automatically performs color matching with available color profiles whenever it draws. See the chapter "Colors and Color-Related Objects" in this book for more information.
View port Defines the location into which a shape is drawn. A view port object describes the clip and mapping associated with a
window (or a part of a window, such as a pane). The mapping defines the location, scale, and orientation of the view port in QuickDraw GX global coordinates. A view port specifies the dithering or halftones used by every object that draws into this window. View ports can be arranged in a hierarchy. See the chapter "View-Related Objects" in this book for more information.
View device Describes the clip, mapping, and bitmap associated with a physical display device such as a monitor or printer. The mapping describes the view device's position and resolution
in QuickDraw GX global coordinates. The bitmap defines the dimensions of the device, the number of bits per pixel, the color representation of each pixel value, and the color profile. See the chapter "View-Related Objects" in this book for more information.
View group Describes an imaging world that is the global space in
which view ports and view devices are located. Within a
view group, view ports and view devices can overlap each other in any combination; the intersection of each view port with a view device determines what is actually visible on that device. Multiple view groups allow for offscreen drawing, in which view ports or view devices can have the same positions
without interfering with each other, since they are in different
coordinate spaces. See the chapter "View-Related Objects" in
this book for more information.
Tag Contains any kind of information an application wants to add
to a QuickDraw GX object. Tag objects are general containers that can have anything in them, from labels to alternate drawing instructions to anything else you feel is useful. You can attach
a tag object to the tag list of most kinds of objects (except tag objects themselves). See the chapter "Tag Objects" in this
book for more information.
Printing objects
Job Holds the primary printing information for a document. Every printable document has a job object associated with it. The job object specifies a number of copies and a page range, and includes references to one or more format objects and two printer objects. See the core printing features chapter of Inside Macintosh: QuickDraw GX Printing for more information.
Format Specifies page-formatting characteristics such as scaling and page dimensions, and includes a reference to a paper-type
object. See the core printing features chapter of Inside Macintosh: QuickDraw GX Printing for more information.
Paper type Specifies a paper-type name (such as "US Letter"), the physical dimensions of the paper, and the printable area within it. See
the core printing features chapter of Inside Macintosh:
QuickDraw GX Printing for more information.
Printer Represents the capabilities of a physical printer and includes a name and type, a driver name and type, and a reference to one or more view device objects that represent imaging areas, and from which you can retrieve information. See the advanced printing features chapter of Inside Macintosh: QuickDraw GX Printing for more information.
Print file Represents the file that results from spooling, which is the preparation of a printable representation of a document. See
the advanced printing features chapter of Inside Macintosh: QuickDraw GX Printing for more information.

Other objects
Font Represents an available font. A font object contains information about the font's names, encodings, font variations, and other tables. See the fonts chapter of Inside Macintosh: QuickDraw GX Typography for more information.
Graphics client Represents the QuickDraw GX memory allocated for an application, which is separate form the memory the application itself occupies and allocates. Each QuickDraw GX application is represented by a graphics client object. A graphics client has no accessible properties. See the memory management chapter of Inside Macintosh: QuickDraw GX Environment and Utilities for more information.
Collection Contains any type of data in any structure. Used by printing objects to hold additional information such as halftoning specifications. Collection objects are not QuickDraw GX
objects; they are managed by the Collection Manager. See
the Collection Manager chapter of Inside Macintosh: QuickDraw GX Environment and Utilities for more
information.

The following figure, Figure 1-13, shows the relationships among the basic QuickDraw GX objects and lists the properties of each object. The appropriate portion
of this figure is reproduced in each chapter that describes a specific kind of object.
Note that, in Figure 1-13, properties that are references (or arrays of references) to other objects are shown in italics; for most of those properties, an arrow extends to the diagram of the referenced object. For clarity, however, some of the arrows are not shown. For example, no object's tag list has an arrow pointing to the diagram of the tag object. For the same reason, the properties of the view port that reference other view ports have no attached arrows.
For a diagram showing all the properties of the printing objects, see the introductory chapter of Inside Macintosh: QuickDraw GX Printing. For a diagram showing the contents of the geometry of each type of shape object, see the chapter "Shape Objects" in this book.
Figure 1-13 Properties of the basic QuickDraw GX objects

QuickDraw GX objects (Continued)
Object	Description
Basic QuickDraw GX objects
`Shape`	Defines the basic representation of a drawable entity. A shape object describes a geometry of a certain type (such as a line, rectangle, bitmap, or text) and how the geometry is framed or filled when drawn. A shape also has references to its three related objects: style, ink, and transform. See the chapter "Shape Objects" of this book for more information. Graphic shape types are described in Inside Macintosh: QuickDraw GX Graphics; typographic shape types are described in Inside Macintosh: QuickDraw GX Typography.
`Style`	Describes certain characteristics affecting how a shape is drawn. For geometric shapes, this includes the thickness of the pen, the starting and ending caps for line segments, joins between line segments, and the dash or pattern to be applied to the shape. For typographic shapes, it includes the font, text size, and typeface of the text. See the chapter "Style Objects" in this book, the geometric styles chapter of Inside Macintosh: QuickDraw GX Graphics, and the typographic styles and layout styles chapters of Inside Macintosh: QuickDraw GX Typography for more information.

`Ink`	Describes a shape's color and its transfer mode (how the color is applied when the shape is drawn). Ink objects support many different kinds of color specification, and many different transfer modes. An ink object can reference a color set object or color profile object or both. See the chapters "Ink Objects" and "Color-Related Objects" in this book for more information.
`Transform`	Describes the clip and mapping applied to a shape when it is drawn. The clip limits the extent of the shape when it is drawn; it may be described by any primitive shape geometry (except picture, text, layout, and multi-bit bitmap). The mapping defines translation, scaling, skewing, rotation or perspective. The transform object also describes the criteria used for hit-testing the shape. Transforms have references to one or more view port objects. See the chapter "Transform Objects" in this book for more information.
`Color set`	Contains an indexed set of colors; analogous to a color table. Color sets are used when colors are specified by index instead of by direct color value. Bitmaps commonly use color sets. See the chapter "Colors and Color-Related Objects" in this book for more information.
`Color profile`	Contains color matching information. The information in a color profile can be used to convert device-specific colors to device-independent colors and back. To provide the most faithful reproduction of colors on different devices, QuickDraw GX automatically performs color matching with available color profiles whenever it draws. See the chapter "Colors and Color-Related Objects" in this book for more information.
`View port`	Defines the location into which a shape is drawn. A view port object describes the clip and mapping associated with a window (or a part of a window, such as a pane). The mapping defines the location, scale, and orientation of the view port in QuickDraw GX global coordinates. A view port specifies the dithering or halftones used by every object that draws into this window. View ports can be arranged in a hierarchy. See the chapter "View-Related Objects" in this book for more information.
`View device`	Describes the clip, mapping, and bitmap associated with a physical display device such as a monitor or printer. The mapping describes the view device's position and resolution in QuickDraw GX global coordinates. The bitmap defines the dimensions of the device, the number of bits per pixel, the color representation of each pixel value, and the color profile. See the chapter "View-Related Objects" in this book for more information.
`View group`	Describes an imaging world that is the global space in which view ports and view devices are located. Within a view group, view ports and view devices can overlap each other in any combination; the intersection of each view port with a view device determines what is actually visible on that device. Multiple view groups allow for offscreen drawing, in which view ports or view devices can have the same positions without interfering with each other, since they are in different coordinate spaces. See the chapter "View-Related Objects" in this book for more information.
`Tag`	Contains any kind of information an application wants to add to a QuickDraw GX object. Tag objects are general containers that can have anything in them, from labels to alternate drawing instructions to anything else you feel is useful. You can attach a tag object to the tag list of most kinds of objects (except tag objects themselves). See the chapter "Tag Objects" in this book for more information.
Printing objects
`Job`	Holds the primary printing information for a document. Every printable document has a job object associated with it. The job object specifies a number of copies and a page range, and includes references to one or more format objects and two printer objects. See the core printing features chapter of Inside Macintosh: QuickDraw GX Printing for more information.
`Format`	Specifies page-formatting characteristics such as scaling and page dimensions, and includes a reference to a paper-type object. See the core printing features chapter of Inside Macintosh: QuickDraw GX Printing for more information.
`Paper type`	Specifies a paper-type name (such as "US Letter"), the physical dimensions of the paper, and the printable area within it. See the core printing features chapter of Inside Macintosh: QuickDraw GX Printing for more information.
`Printer`	Represents the capabilities of a physical printer and includes a name and type, a driver name and type, and a reference to one or more view device objects that represent imaging areas, and from which you can retrieve information. See the advanced printing features chapter of Inside Macintosh: QuickDraw GX Printing for more information.
`Print file`	Represents the file that results from spooling, which is the preparation of a printable representation of a document. See the advanced printing features chapter of Inside Macintosh: QuickDraw GX Printing for more information.

Other objects
`Font`	Represents an available font. A font object contains information about the font's names, encodings, font variations, and other tables. See the fonts chapter of Inside Macintosh: QuickDraw GX Typography for more information.
Graphics client	Represents the QuickDraw GX memory allocated for an application, which is separate form the memory the application itself occupies and allocates. Each QuickDraw GX application is represented by a graphics client object. A graphics client has no accessible properties. See the memory management chapter of Inside Macintosh: QuickDraw GX Environment and Utilities for more information.
Collection	Contains any type of data in any structure. Used by printing objects to hold additional information such as halftoning specifications. Collection objects are not QuickDraw GX objects; they are managed by the Collection Manager. See the Collection Manager chapter of Inside Macintosh: QuickDraw GX Environment and Utilities for more information.